home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / MODEMPRO / TELESHAR.ZIP;1 / DOCHELP@.EXE / RUNT.DOC < prev    next >
Encoding:
Text File  |  1993-05-21  |  7.7 KB  |  191 lines
  1.  
  2.  
  3.                     RUNT -  The RUN Timer  Manual      Page 1
  4.  
  5.  
  6.  
  7.  
  8.                         _______
  9.                    ____|__     |               (R)
  10.                 --|       |    |-------------------
  11.                   |   ____|__  |  Association of
  12.                   |  |       |_|  Shareware
  13.                   |__|   o   |    Professionals
  14.                 -----|   |   |---------------------
  15.                      |___|___|    Member
  16.  
  17.  
  18.  
  19.  
  20.           The RUNT is an ASP member Shareware product.
  21.  
  22.  
  23.           The  purpose of the RUNT is allow you to run any software
  24.           at timed intervals.  The idea is that you may  well  have
  25.           tasks   that  can  be  done  with  minimal  or  no  human
  26.           intervention, over a  break  like  tea  time,  lunch,  or
  27.           overnight.   The RUNT takes a set of up to 30 programs to
  28.           run from the TODO_NOW or EVENTS.NOW  text  command  file,
  29.           and then  runs  them  at  specified  times.    If you put
  30.           instructions for previous hours in the command file,  the
  31.           RUNT will  only  grab  the  previous hour's commands.  It
  32.           will treat the remainder as  instructions  for  the  next
  33.           day.   The  run defaults to swapping all but 2K of itself
  34.           out to disk when it runs another program.
  35.  
  36.           To run the RUNT you just type in its name and wait as  it
  37.           looks for  a  current copy of the command file.  It grabs
  38.           its setup information from the file, sets itself  up  and
  39.           runs.  If there is no current command file, or no current
  40.           entries it  complains.    If you wish you can use another
  41.           setup file as a parameter with the  RUNT  as  shown  with
  42.           "RUNT  \mystuff\ToBeRun"  in place of, or in addition to,
  43.           the command file.  This allows you to have many  programs
  44.           to  run, and to repeatedly cycle through the runs (eg for
  45.           testing or  other  repeating  activities).     The   RUNT
  46.           automatically  rereads  the  setup  file each hour, which
  47.           allows another process to  renew  the  file  for  it  and
  48.           reloads the runs that are repeated every hour.
  49.  
  50.           Optional command line usage:
  51.  
  52.           -H for the usage screen.
  53.  
  54.           -Ffilename  to  allow you to specify an alternate command
  55.           file.
  56.  
  57.           -S to tell the RUNT to swap to the PROGRAM, specified  in
  58.           the command file (or tsphone).
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                     RUNT -  The RUN Timer  Manual      Page 2
  67.  
  68.  
  69.           Some features:
  70.  
  71.           Some  years  of  instructions  for programs to run can be
  72.           stored in the events.dbf  database.    These  values  are
  73.           transferred   to  the  command  file  (EVENTS.NOW)  using
  74.           TSPHONE.  See the TSPHONE.DOC  and  the  online  help  in
  75.           TSPHONE.
  76.  
  77.           Programs  like  OPMENU  and TSPHONE allow you to run many
  78.           more than 30 programs with  more  flexibility  by  adding
  79.           multiple entry numbers on the RUNT program to be run line
  80.           as in  "OPMENU  -R  1  4  67  213 9917".  With each entry
  81.           number then running one after the previous at  and  after
  82.           the time  specified  for  the entry.  Plus each entry can
  83.           easily contain instructions to run  several  programs  in
  84.           programmed sequence.
  85.  
  86.           CHECKDATE
  87.           Adding "CHECKDATE" early in the instructions for the file
  88.           tells  RUNT to only use the file if it is current and has
  89.           today's file date.  The RUNT quits if there is no current
  90.           script file.
  91.  
  92.           DELAY 25
  93.           Delay allows you to change the display  reading  time  in
  94.           seconds.  The default value is 15 seconds.  See also WAIT
  95.           below.
  96.  
  97.           NOSWAP
  98.           Adding "NOSWAP" on the program to run line tells the RUNT
  99.           not  to  swap  itself to disk before running the program.
  100.           This is somewhat faster and quite feasable  when  running
  101.           most general  utility  programs.  The RUNT occupies about
  102.           100k when running another program using NOSWAP.
  103.  
  104.           QUIT
  105.           A program to run named "QUIT"  will  cause  the  RUNT  to
  106.           quit.
  107.  
  108.           RELOAD
  109.           Using   "RELOAD   somefile"  tells  RUNT  to  reload  its
  110.           instructions from the specified 'somefile'.  This  allows
  111.           you  to  chain  groups of instructions to overcome the 30
  112.           instruction limit.  If you do not include  a  file  name,
  113.           the RUNT assumes that you want to reload from TSPHONE and
  114.           the  events  database, so it automatically runs the phone
  115.           program to create a new script file.    Any  reload  that
  116.           occurs in the first hour of the day (just after midnight)
  117.           includes  an  automatic CHECKDATE to ensure that the RUNT
  118.           does not use one day's script file on the next day.    If
  119.           no current script file is found the RUNT quits.
  120.  
  121.           WAIT
  122.           The  WAIT command can be used on the same line as another
  123.           command to tell the runt program to wait so you  can  see
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                     RUNT -  The RUN Timer  Manual      Page 3
  130.  
  131.  
  132.           the results  of the command.  It is actually a long delay
  133.           so you can include it in scripts that are run when nobody
  134.           is around.
  135.  
  136.           TODO_NOW  (EVENTS.NOW)
  137.           TODO_NOW is the default name for the file the RUNT  reads
  138.           in to   get   its   instructions.    Its  alternate  name
  139.           EVENTS.NOW is generated automatically from the EVENTS.DBF
  140.           database by the TSPHONE program, and you  can  also  just
  141.           create or  edit  an  existing command file.  Many current
  142.           users just use  their  text  editor  to  edit  and  reuse
  143.           existing command files.
  144.  
  145.           The RUNT is not a TSR or RAM resident program.
  146.  
  147.           This  product  is  Copyright (C) 1993 P. C. Softsmith all
  148.           rights reserved.  It is distributed as shareware and must
  149.           be distributed with this documentation.  It  is  normally
  150.           distributed  with  other  P.C.  Softsmith  materials that
  151.           further explain the shareware process.  If  you  wish  to
  152.           distribute  it  with  your software or are unable to find
  153.           the other documentation that should accompany  this  file
  154.           (such   as   the   SHR_WARE.DOC,   FILE_ID.DIZ,  and  the
  155.           VENDOR.DOC) please contact whoever gave you the  software
  156.           or P.C. Softsmith.
  157.  
  158.  
  159.           For  technical  support,  either  call (604) 433-5189, or
  160.           write to Suite 606 -  6455  Willingdon  Avenue,  Burnaby,
  161.           British Columbia,  Canada,  V5H 4E4.  Both registered and
  162.           soon to  be  registered  users  currently  get  the  same
  163.           support without  any  arbitrary time limit.  You may also
  164.           try leaving a Compuserve message at 75020, 2664, or  send
  165.           email to INTERNET:vic_williams@mindlink.bc.ca
  166.  
  167.  
  168.           THE DOCUMENTATION AND ASSOCIATED SOFTWARE ARE DISTRIBUTED
  169.           AND  SOLD  WITH NO WARRANTIES, EITHER EXPRESS OR IMPLIED,
  170.           REGARDING  ITS  MERCHANTABILITY  OR   FITNESS   FOR   ANY
  171.           PARTICULAR PURPOSE.        THE    INFORMATION   IN   THIS
  172.           DOCUMENTATION IS SUBJECT TO  CHANGE  WITHOUT  NOTICE  AND
  173.           DOES  NOT  REPRESENT  A  COMMITTMENT  ON  THE PART OF THE
  174.           VENDOR.
  175.  
  176.           OTHER PRODUCT AND BRAND NAMES MENTIONED ARE TRADEMARKS OR
  177.           REGISTERED  TRADEMARKS  OF  THEIR   RESPECTIVE   HOLDERS.
  178.           SPECIFICALLY  XBASE  IS  THE  GENERIC  DATABASE  INDUSTRY
  179.           REPLACEMENT  FOR  THE  REGISTERED  TERM  DBASE  OWNED  BY
  180.           BORLAND INTERNATIONAL.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.